终于搞定了UniApp开发的微信小程序的支付,分享下有关微信支付踩的坑

您所在的位置:网站首页 uniapp 微信支付 调不起来 终于搞定了UniApp开发的微信小程序的支付,分享下有关微信支付踩的坑

终于搞定了UniApp开发的微信小程序的支付,分享下有关微信支付踩的坑

2024-04-27 14:01| 来源: 网络整理| 查看: 265

之前用H5+做过微信支付和支付宝支付,是一年前做的,有些细节忘记了,本以为不会费太多时间,结果搞了12个小时

记录一下踩过的坑,包括:调用支付JSAPI缺少参数: total_fee,支付验证签名失败,不识别的参数body!!!等我都碰到了

如何去微信那边申请【公众平台】【商户平台】【开放平台】本来不想讲,但是这几个平台也确实容易把人搞晕,还是大致说说我的理解吧,也算是梳理下自己的思路,方便新手,老手绕道:

最早就一个【公众号平台:mp.weixin.qq.com】,2015-2016年那会儿做微信公众号特别火,所以大家最早接触的是它,此前微信支付还不对公众开放,后来有了服务号之后,可以做公众号商城,有了支付需求,微信推出了【商户平台:pay.weixin.qq.com】,从公众号平台,有一个按钮点击就进入了商户平台,,最早的微信支付就只有JSAPI方式,也就是在微信内置浏览器里支付,后来增加了H5网页支付、Native支付、App支付、付款码支付,见下图:

我们一般开发者大多数用到的是JSAPI和App两种,微信公众号服务号、公众号商城、包括后来的小程序,都是用的JSAPI方式,用HBuilder和HBuilderX开发的跨平台App用的是App方式。

【开放平台:open.weixin.qq.com】又是什么呢?如果我们想做一个App或微信小程序要集成微信支付功能,需要注册哪些呢?需要注册【微信开放平台】,在开放平台里注册开发者账号,把自己的应用(就是我们的manifest.json里的那个appid)登记上去,然后要申请支付功能,申请支付功能就等于是开通了【商户平台】,因为钱要去这里,如果已经有了【商户平台】就可不用再申请了,见下图:

当然开放平台不单单包括微信支付,还包括其他接入服务,包括(移动应用,网站应用,公众账号,第三方平台)

题外话:微信公众号平台是要年审的,费用300,,开放平台也是要年审的,也是300。

小程序是要单独注册的,但是也是在微信公众平台的页面mp.weixin.qq.com注册,不过要另外注册账号,不能使用已有的微信公众号账号,但是申请成功后,可以挂靠/绑定在某个已有的【公众号】上,同时可以关联已有的【商户平台】。

我个人感觉,小程序是微信公众号的JSSDK可以调用的一大堆接口+Vue的框架的一种集成,过去的微信公众号(服务号)的开发基本上纯后台的,前端技术的不断发展,尤其是Vue这类前端框架,让前端可以做更多的事,包括一些复杂的界面成为可能。

以上梳理了微信几大平台的关系,啰啰嗦嗦说了一堆自己的感受,还回到文章的题目上,说说微信小程序支付的坑。

正是因为有几大平台,所以好多知识点分散在各个平台的文档里,而且不断的版本迭代,文档之间也有所差异,之前做App支付,比较顺利,这次做小程序支付,就因为之前没把所有这些知识点贯通起来,所以碰到了点问题:

整个支付流程: App或小程序,创建自己的订单------>后台访问统一下单接口:https://api.mch.weixin.qq.com/pay/unifiedorder,生成预支付订单,同时提供回调地址--------->预支付订单返回到App或小程序,调起支付,前台支付成功,跳转到相关页面-------->微信支付平台会异步给回调地址发送支付成功的结果通知,通知地址的程序接收到微信的通知,根据返回参数修改自己的订单的支付状态

0.【微信支付商户平台】设置支付目录:

先说uni-app的支付:官方文档链接:https://uniapp.dcloud.io/api/plugins/payment,这个接口只是唤起支付的接口,在此之前要做些准备的,以上的几大平台,需要注册开通,该注册的注册,该关联的关联,技术上最关键一点是要先创建预支付订单(创建预支付订单在App和微信小程序是一样的,支付宝也类似,也要先创建预支付订单);

再说H5+也就是App的支付:官方文档链接:http://www.html5plus.org/doc/zh_cn/payment.html,这个接口只是在App端唤起支付,前提条件依然是创建预支付订单,得到返回值,然后被这个接口调用,以唤起支付。

如何创建预支付订单,我借用的是DCloud提供的示例程序:https://github.com/dcloudio/H5P.Server/tree/master/payment/wxpayv3,PHP的示例代码,这部分代码的更新时间是2年前和4年前了,但是依然能用,不过有些小地方要做点修改,因为微信那边有些参数的名字有所改变,后面会提到。

首先在WxPay.Config.php里配置自己的各项参数:

const APPID = 'wxb1马赛克c90a'; const MCHID = '150马赛克021'; const KEY = 'ET5g6马赛克E3dxMb7iUxL'; //这个KEY就是 const NOTIFY_URL = "https://www.马赛克.cn/order/WxPay/notify.php";

然后在index.php里填写自己app或小程序传来的参数,这个index.php也就是自己的app或小程序访问的入口:

…… 不管是用Post还是Get方法,总之要获取从app或小程序传来的自己的参数和生成预支付订单所需要的参数 …… ///////////////////////// //填写生成统一下单的各项参数 ///////////////////////// // 商品或支付单简要描述 $subject = 'XXX-订单号:' . $request_json['jxcbillnumber']; //自己的商城或平台的商品名或订单号 //之前有乱码问题,现在好像只要是utf-8就不会乱码,所以不用转成iso-8859-1了,至少php平台大家都会用utf-8来做开发,java平台对编码问题很敏感,可能要注意 //$subject = iconv("utf-8","iso-8859-1",$subject); // 内部订单号,示例代码使用时间值作为唯一的订单ID号,如果使用自己创建的订单号,如果取消支付了,再次支付时会发生错误,所以可能要每次生成不同的内部订单号 //$out_trade_no = date('YmdHis', time()); //订单金额,以分为单位 $total = 1; $unifiedOrder = new WxPayUnifiedOrder(); $unifiedOrder->SetBody($subject); //商品或支付单简要描述 $unifiedOrder->SetOut_trade_no($out_trade_no); //支付订单号 $unifiedOrder->SetTotal_fee($total); //订单金额,也就支付金额,以分为单位 //////////////////////////////////////////////////////////////////////////////////// //APP只要一个参数 //$unifiedOrder->SetTrade_type("APP"); //JSAPI需要再设置openid $unifiedOrder->SetTrade_type("JSAPI"); $unifiedOrder->SetOpenid( $request_json['openid'] ); //openid是什么不用多解释了吧,做过微信公众号的都知道 /////////////////////////////////////////////////////////////////////////////////// //查看生成订单前的各项数据 console_log_wx( 'unifiedOrder前::' . json_encode( $unifiedOrder->GetValues() ) ); $result1 = WxPayApi::unifiedOrder($unifiedOrder); //查看生成订单后的各项数据 console_log_wx( 'unifiedOrder后::' . json_encode($result1) ); //生成的统一下单结果发回app或小程序 if (is_array($result1)) { echo json_encode($result1); } //查询生成的统一下单情况,可以看到生成的订单有什么错误,但是这个错误也不准确,很不靠谱 $result2 = WxPayApi::orderQuery($unifiedOrder); console_log_wx( 'orderQuery::'.json_encode($result2) );

生成了统一下单的参数,返回给App或小程序,App用plus.payment.request(), 小程序用uni.requestPayment(),可以唤起支付窗口,但是得到一个-1的提示,大家遇到的最多了,如果查询统一下单查询的日志:

$result2 = WxPayApi::orderQuery($unifiedOrder); console_log_wx( 'orderQuery::'.json_encode($result2) );

可能就会看到:调用支付JSAPI缺少参数: total_fee,支付验证签名失败,不识别的参数body!!!等奇怪错误,然后开始折腾total_fee,折腾utf-8转iso-8859-1,都没用,原因是微信那边在生成预支付订单后,不同的平台,对参数的个数和名字有所不同:

再仔细读一下这两个平台的流程和相关参数的说明:

======================== APP ======================== App的业务流程:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=8_3 App的参数说明:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12

没时间看文档,我们就直接贴图吧,这是供:plus.payment.request()在App唤起支付调用的参数,注意这里变量名都是小写的,而且没有下划线,没有驼峰命名 并且prepayid的内容就是prepayid的内容,不需要写成prepay_id=xxxxxx

======================== JSAPI ======================== JSAPI也就是公众号或小程序的业务流程:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_4 JSAPI也就是公众号或小程序的参数说明:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6

***这些参数也就是供uni.requestPayment()在公众号或小程序里唤起支付调用的参数,注意这里的变量名跟App有所不同,个数也不同,而且package要写成prepay_id=xxxxxx的格式,真是个大坑啊!!!如果这里有一个字符不对或者大小写不对,就会支付失败,然后给出莫名其妙的错误

直接上图:

两种方式里都提到了签名,签名又是什么呢?看官方的说明,其实二者是一样的算法,只是参数个数不同,参数的名字也不同,参数的内容细微差别,两个文档里都提到:注意:签名方式一定要与统一下单接口使用的一致:

APP的签名说明:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=4_3 JSAPI的签名说明:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3

是时候回去再看:https://github.com/dcloudio/H5P.Server/tree/master/payment/wxpayv3里的代码了,在WxPay.Api.php这个文件里,有关签名的部分:

public static function unifiedOrder($inputObj, $timeOut = 6) { $url = "https://api.mch.weixin.qq.com/pay/unifiedorder"; //检测必填参数 if(!$inputObj->IsOut_trade_noSet()) { throw new WxPayException("缺少统一支付接口必填参数out_trade_no!"); }else if(!$inputObj->IsBodySet()){ throw new WxPayException("缺少统一支付接口必填参数body!"); }else if(!$inputObj->IsTotal_feeSet()) { throw new WxPayException("缺少统一支付接口必填参数total_fee!"); }else if(!$inputObj->IsTrade_typeSet()) { throw new WxPayException("缺少统一支付接口必填参数trade_type!"); } //关联参数 if($inputObj->GetTrade_type() == "JSAPI" && !$inputObj->IsOpenidSet()){ throw new WxPayException("统一支付接口中,缺少必填参数openid!trade_type为JSAPI时,openid为必填参数!"); } if($inputObj->GetTrade_type() == "NATIVE" && !$inputObj->IsProduct_idSet()){ throw new WxPayException("统一支付接口中,缺少必填参数product_id!trade_type为JSAPI时,product_id为必填参数!"); } //异步通知url未设置,则使用配置文件中的url if(!$inputObj->IsNotify_urlSet()){ $inputObj->SetNotify_url(WxPayConfig::NOTIFY_URL);//异步通知url } $inputObj->SetAppid(WxPayConfig::APPID);//公众账号ID $inputObj->SetMch_id(WxPayConfig::MCHID);//商户号 $inputObj->SetSpbill_create_ip($_SERVER['REMOTE_ADDR']);//终端ip //$inputObj->SetSpbill_create_ip("1.1.1.1"); $inputObj->SetNonce_str(self::getNonceStr());//随机字符串 //签名 $inputObj->SetSign(); $xml = $inputObj->ToXml(); $startTimeStamp = self::getMillisecond();//请求开始时间 $response = self::postXmlCurl($xml, $url, false, $timeOut); $result = WxPayResults::Init($response); // 统一下单接口返回正常的prepay_id,再按签名规范重新生成签名后,将数据传输给APP。 // 参与签名的字段名为appId,partnerId,prepayId,nonceStr,timeStamp,package。注意:package的值格式为Sign=WXPay $time_stamp = time(); $pack = 'Sign=WXPay'; //////////////////////////////////////////////////////////////////////////////////////////////////////////////// ///重点在下面:这段代码是App的签名用的,小程序的要改成小程序的参数格式,根据自己的环境来选用哪一段 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////// // App输出参数列表 $prePayParams =array(); $prePayParams['appid'] =$result['appid']; $prePayParams['partnerid'] =$result['mch_id']; $prePayParams['prepayid'] =$result['prepay_id']; $prePayParams['noncestr'] =$result['nonce_str']; //这里要改成 WxPayApi::getNonceStr(); $prePayParams['package'] =$pack; $prePayParams['timestamp'] =$time_stamp; ////////////////////////////////////////////////////// ////////////////////////////////////////////////////// //JSAPI小程序输出参数列表 //输出参数列表,与App的参数有所不同,请参考最新的文档来确定参数的个数和大小写,注意!!! $prePayParams =array(); $prePayParams['appId'] = $result['appid']; $prePayParams['timeStamp'] = time(); $prePayParams['nonceStr'] = WxPayApi::getNonceStr(); $prePayParams['package'] = 'prepay_id=' . $result['prepay_id']; $prePayParams['signType'] = 'MD5'; //echo json_encode($prePayParams); $result = WxPayResults::InitFromArray($prePayParams,true)->GetValues(); self::reportCostTime($url, $startTimeStamp, $result);//上报请求花费时间 ////////////////////////////////////////////////////// return $result; }

另外notify.php也要做一些修改,这是接受微信支付成功之后的异步回传的接口,大家发挥自己的创造力吧,啰嗦了一大堆,只是记录自己踩过的坑,以及浪费的12个小时。



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3